home *** CD-ROM | disk | FTP | other *** search
/ Light ROM 1 / LIGHT-ROM 1 (Amiga Library Services)(1994).iso / ffdisks / d923.lha / MagicPubName / MagicPubName.dok < prev    next >
Text File  |  1993-10-07  |  6KB  |  129 lines
  1.  
  2.     --------------------------------------------------------------------
  3.     MagicPubName 1.3a (6.8.93) © Franz.Schwarz@mil.ka.sub.org - Freeware
  4.     --------------------------------------------------------------------
  5.  
  6. MagicPubName ist, wie der Name bereits impliziert, ein kleines, aber
  7. vielseitiges und mächtiges Utility, mit dem der Name von öffentlichen
  8. Schirmen erfragt werden kann.  Die Funktionalität und Sicherheit dieses
  9. Utilities geht weit über die anderer 'GetPubName'-Utilities hinaus.  Ab
  10. Version 1.2 kann MagicPubName zudem öffentliche Schirme nach vorne bringen.
  11.  
  12. Anhand der Kommandozeilen-Argument-Schablone
  13.  
  14. RequireVisible=RV/S,RequireFront=RF/S,Default/S,Shanghai/S,ConsoleScr=Con/S
  15.         ScreenName=Scr,Case/S,WBOnFailure=WBF/S,ToFront/S,Quiet=Q/S
  16.  
  17. läßt sich die Funktion von MagicPubName erkennen:
  18.  
  19.  
  20. Es können mehrere Schalter und der Name des öffentlichen Schirms
  21. spezifiziert werden.  Der öffentliche Schirm wird dann anhand dieser
  22. angeführten Argumente ermittelt und sein Name auf dem aktuellen
  23. Ausgabekanal ausgegeben, falls ein öffentlicher Schirm gefunden wurde, der
  24. allen spezifizierten Argumenten gerecht wird.  Wenn kein passender Schirm
  25. gefunden wurde, wird kein Schirmname ausgegeben, sondern der Rückgabewert
  26. auf WARN (5) gesetzt, es sei denn, es wurden dem Programm keine Argumente
  27. abgesehen von ToFront/S & Quiet=Q/S übergeben oder es wurde der
  28. WBOnFailure-Schalter spezifiziert:  in diesen Fällen wird, wenn kein
  29. passender Schirm gefunden werden konnte, zusätzlich zum Rückgabewert WARN
  30. der Name des standardmäßigen öffentlichen Schirms oder, falls dieser nicht
  31. ermittelt werden kann, "Workbench" ausgegeben.
  32.  
  33. Zu den Argumenten im einzelnen:
  34.  
  35. RequireVisible=RV/S:  wird dieser Schalter angegeben, dann muß ein
  36. passender öffentlicher Schirm (zumindest ein Teil des Schirms) gegenwärtig
  37. sichtbar sein.
  38.  
  39. RequireFront=RF/S:  falls dieser Schalter aufgeführt wird, so muß ein
  40. passender öffentlicher Schirm der oberste Schirm, der gegenwärtig angezeigt
  41. wird, sein.
  42.  
  43. Default/S:  die Angabe dieses Schalters bedeutet, daß ein passender
  44. öffentlicher Schirm gleichzeitig der aktuelle standardmäßige öffentliche
  45. Schirm sein muß.
  46.  
  47. Shanghai/S:  wenn dieser Schalter spezifiziert wird, dann muß ein passender
  48. öffentlicher Schirm gleichzeitig der Schirm sein, auf dem gegenwärtig die
  49. Fenster geöffnet werden, deren NewWindow.Type-Eintrag auf WBENCHSCREEN
  50. gesetzt ist (z.B.  CON:-Fenster ohne /SCREEN- Spezifikation im Namen).
  51.  
  52. ConsoleScr=Con/S:  falls dieser Schalter angegeben wird, dann paßt ein
  53. öffentlicher Schirm nur, wenn der aktuelle Eingabekanal eine interaktive
  54. Konsole darstellt, die zur Ein-/ Ausgabe ein Intuition-Fenster auf der
  55. selben Maschine verwendet, und deren Intuition-Fenster auf dem öffentlichen
  56. Schirm geöffnet ist.
  57.  
  58. ScreenName=Scr:  wenn ein Schirmname genannt wird, dann muß ein passender
  59. öffentlicher Schirm mit diesem Namen übereinstimmen.  Standardmäßig wird
  60. dabei zuerst ein Schirm gesucht, dessen Namen genau mit dem genannten Namen
  61. übereinstimmt.  Falls der Schalter Case/S nicht angegeben wurde, wird
  62. zusätzlich in einem zweiten Durchgang schließlich auf Namensübereinstimmung
  63. geprüft, ohne Groß-/ Kleinschreibung heranzuziehen.
  64.  
  65. Case/S:  dieser Schalter ist nur bei angegebenem ScreenName=Scr-Argument
  66. gültig - andernfalls bricht MagicPubName mit Rückgabewert 20 (FAIL) ab.
  67. Seine Funktion wird in der Dokumentation des ScreenName=Scr- Argumentes
  68. beschrieben.
  69.  
  70. WBOnFailure=WBF/S:  falls dieser Schalter spezifiziert wird, so gibt
  71. MagicPubName den Namen des standardmäßigen öffentlichen Schirms (bzw.
  72. "Workbench", falls der Name des standardmäßigen öffentlichen Schirms nicht
  73. in Erfahrung gebracht werden kann) auf dem aktuellen Ausgabekanal aus, wenn
  74. kein passender öffentlicher Schirm, der allen angegebenen Argumenten
  75. gerecht wird, gefunden werden konnte.
  76.  
  77. ToFront/S:  dieser Schalter bewirkt, daß der öffentliche Schirm, dessen
  78. Namen ausgegeben wird, nach vorne gebracht wird.
  79.  
  80. Quiet=Q/S:  Schalter, der MagicPubName anweist, ruhig zu sein (d.h.  nichts
  81. auszugeben) außer es schläge mit einem Rückgabewert größer Dos.warn (5)
  82. fehl.
  83.  
  84. Falls keines der Argumente RequireFront=RF/S, Default/S, Shanghai/S,
  85. ConsoleScr=Con/S und ScreenName=Scr angegeben wird, dann wird der vorderste
  86. (teilweise) sichtbare öffentliche Schirm oder, falls kein öffentlicher
  87. Schirm gegenwärtig sichtbar ist, der standardmäßige öffentliche Schirm als
  88. passend betrachtet, sofern er den Bedingungen der anderen angegebenen
  89. Argumente genügt.
  90.  
  91.  
  92. Durch die Rückgabe von WARN (5), falls kein passender öffentlicher Schirm
  93. gefunden wird, und durch die vielen Filter-Arguemnte, allen voran das
  94. ConsoleScr=Con-Argument, eignet sich MagicPubName besonders zum Einbau in
  95. eigene ARexx-Skripte und Stapelverarbeitungsdateien.
  96.  
  97. Aus Kompatibilitätsgründen mit bestehenden ARexx-Skripten,
  98. Stapelbearbeitungsdateien und Alias-Definitionen, wird empfohlen,
  99. MagicPubName ins Verzeichnis c:  zu kopieren, und es dann mit 'MakeLink
  100. c:GetPubName c:MagicPubName Hard' außerdem unter dem üblicherweise für die
  101. trivialen GetPubName-Utilities üblichen Namen zugänglich zu machen.
  102.  
  103. MagicPubName ist reentrant, 'pure'.  Da es zudem trotz seiner
  104. Leistungsfähigkeit ziemlich klein ist, wird empfohlen, es resident zu
  105. machen.  ('resident c:MagicPubName' oder / und 'resident c:GetPubName')
  106.  
  107.  
  108. MagicPubName ist Freeware, i.e., es ist frei kopierbar, das
  109. Urheberrecht liegt aber weiterhin beim Autor.  Eine Haftung des
  110. Autors für Schäden, die unmittelbar oder mittelbar von dem Gebrauch
  111. von MagicPubName herrühren, ist definitiv ausgeschlossen.  Die
  112. Verwendung von MagicPubName erfolgt auf Ihr eigenes Risiko.  In
  113. angelsächsischem Jargon wird dies gemeinhin als 'Use At Your Own
  114. Risk' bezeichnet.
  115.  
  116.  
  117.     MagicPubName geschrieben und urheberrechtlich geschützt, © 1993 by 
  118.        Franz Schwarz, Mühlenstraße 2, D-78591 Durchhausen, Germany.
  119.           uucp: Franz.Schwarz@mil.ka.sub.org; Fido: 2:241/7506.18
  120.  
  121.  
  122. Anregungen, Kritik, Flames, Geld, Gold, Disketten, Bier, Schokolade, nette
  123. Postkarten, e-mails, etc. sind jederzeit herzlich willkommen!;-)
  124.  
  125.  
  126.     Bye
  127.       Franz 'Blacky' Schwarz
  128.  
  129.